home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 2: CDPD 1 / Almathera Ten on Ten - Disc 2: CDPD 1.iso / pd / 401-425 / 406 / dirwork / dw.doc < prev    next >
Text File  |  1995-03-14  |  14KB  |  379 lines

  1.  
  2.     DirWork V1.12 - Chris Hames 17/8/90.  All rights Reserved.
  3.     ----------------------------------------------------------
  4.             DW Size 29400 bytes
  5.  
  6.     Need to get around your directories fast and simply.  Force yourself
  7. to read fully this doc file and I think you will find this program of great
  8. use.  What makes DirWork better than the rest ?
  9.  
  10.     VERY Configurable.  Buttons/Options/WindowSize can be modified and
  11.     the DW executable modified to have these values.
  12.  
  13.     Fast and Smooth Floppy Dirs!  Getting a directory off a floppy
  14.         is usually up to 2 times faster.  And your drive doesn't grind
  15.         back and forward anywhere near as much as normal.
  16.  
  17.     Size.  At less than 30K uncompressed in makes mince meat of most
  18.     of those huge memory hungry utils.
  19.  
  20.     Detaches.  So when you type DW from CLI you can still use your
  21.         CLI as if nothing happened.  No need to Run!
  22.  
  23.     Sleep. Can be put to sleep so it disappears completely until you
  24.     press left Ctrl-Shift-Alt-D.  Also can be started in sleep mode
  25.     so "DW -s" in your startup-sequence will have it there for when
  26.     you want it.
  27.  
  28.     Intelligent.  Press the right mouse button on the filename of a
  29.     IFF picture and it will be automatically displayed.  Right button
  30.     on a text file and it will type or edit it.  As well as many other
  31.     instant actions on different types of files.
  32.  
  33.     A excellent show built in that loads in the next picture while your
  34.     looking at the last.  You can of course set up a button to use your
  35.     own show utility.
  36.  
  37. This program is SHAREWARE so please support the work that has gone into it.
  38. The suggested contribution of $20 will get you a disk containing the next
  39. version of this program. Please send the contribution & any ideas etc to:-
  40.     C Hames            |
  41. Snail:    6 Pamela Crt        |Internet(for 1990):
  42.     Blackburn South        | ins778u@vax4.cc.monash.edu.au
  43.     VIC 3130        |BBS's:
  44.     Australia        | A few Amiga ones in Melbourne
  45. And don't forget to include the version number you have!
  46.  
  47. PS If any software company is reading this!  Want a 19 year old C/Assembler
  48.    programmer who is getting bored out of his mind in computer science at
  49.    Uni.
  50.  
  51. This program may be copied as long as it is accompanied by this doc file
  52. both unaltered & no money is charged(except for a reasonable copying fee). 
  53. All use of this program is at your own risk & I assume no responsibility
  54. for any problems that occur.
  55.  
  56. Future Improvements:-
  57.     More configurable. ie Screens/ButtonPositions etc
  58.     Search to show area around hits.
  59.     Much better Type/Htype.
  60.     Virus BootBlock Check(just find non-standard ones).
  61.     Faster.
  62.  
  63. History:-
  64.     27/ 1/90 1.00    First Release.
  65.      5/ 2/90 1.01    VMK updated to v27.  Stopped title bar flashing.
  66.     12/ 2/90 1.02    Icon. Faster. Smaller. Now uses less memory(5K) if
  67.             destination display is not used.
  68.     15/ 2/90 1.03    Detaches from CLI.  Some Workbench problems fixed.
  69.             A Show bug fixed.
  70.     22/ 2/90 1.04    CD bug fixed.  Volumes button added.  Dir buttons
  71.             and options can be modified and saved.  VMK can
  72.             now automatically be executed every 10 secs.
  73.     14/ 7/90 1.10    Heaps of little improvements. Copy/Delete/Move Dirs.
  74.             Now VERY configurable buttons. Sleep. Window sizing.
  75.             HxType/Type/Search Esc works anytime now. Rename/
  76.             makdir/copy/move/delete add or remove from both
  77.             filelists where appropriate.  So many more changes
  78.             that I am calling it 1.10 !
  79.     30/ 7/90 1.11    Bug fixed when getting dirs with spaces in them.
  80.     17/ 8/90 1.12    Rare problem getting dirs with spaces at end.
  81.  
  82. Instructions:-
  83. ------------
  84. The window display
  85.     +-------------------------------------------------------+
  86.     |+|  Title Bar - Chip & total memory available      | |    |
  87.     |-------------------------------------------------------|
  88.     | Source File List    |S|    Name & Bytes Free    |
  89.     |            |l|    SOURCE DIRECTORY    |
  90.     | Filename      p size    |i|                |
  91.     |         ^    |d|    +++ +++ +++ +++    +++    |
  92.     |  p if Protected    |e|    +++ + Buttons + +++    |
  93.     |            | |    +++ +++ +++ +++    +++    |
  94.     |            |G|    +++ +++ +++ +++    +++    |
  95.     | & Destination File    |a|                |
  96.     | list if selected    |d|    DESTINATION DIRECTORY    |
  97.     |-------------------------    Name & Bytes Free    |
  98.     |Errors and other messages                |
  99.     +-------------------------------------------------------+
  100.  
  101. FileList(s)
  102.     Press the left mouse button to select/deselect a file or directory
  103.     name.  Right mouse button on a directory reads in that directory.
  104.         Right Mouse Button on a file will try to recognize the file and
  105.     automatically do something with the file(eg With default settings
  106.     the Right mouse button on a text file will type it & on a picture
  107.     file will show it.  If it doesn't it will HxType the file.)
  108.     Use the slide gadget to see files that are not displayed.
  109.  
  110. Buttons
  111.     The main idea is to press the left mouse button if you are referring
  112.     to the source and the right mouse button for the destination.
  113.     (eg Left button on DF0: will get the directory from DF0: and put it
  114.     in the source file list, but right button on DF0: will get the
  115.     directory DF0: and put it in the destination file list)
  116.  
  117.     Below is a description of what the buttons will do when the default
  118.     setup is used.  If a button has an "*" next to the desciption then
  119.     pressing the right mouse button on a file that is relevent to the
  120.     operation of the button will automatically perform the button
  121.     function on the file(eg right mouse button pressed on a a picture
  122.     file will perform show and display the picture).  You can modify
  123.     button functions to do something completely different if you want.
  124.     The text in quotes refers to configuration information which can be
  125.     ignored until later.
  126.  
  127.     DF0: DF1: RAM: DH0: etc
  128.         Just press these to get the directory of this name.
  129.         " DF0: ,D00,DF0:" where the DF0: could be RAM: etc
  130.  
  131.     Sleep    Puts the task to sleep until you press the four left keys
  132.         Ctrl-Shift-Alt-D.  ie The window disappears as if you quit
  133.         but the program is still there waiting until you press the
  134.         keys.  So you don't have to load DirWork all the time.
  135.         DirWork starts in Sleep mode if you type DW -s instead of
  136.         the usual DW when you run it from CLI.
  137.         "Sleep ,S00,"
  138.  
  139.     Volumes    Displays all things assigned ie C: LIBS: SYS: etc
  140.         Just press a button on one of them to enter the directory.
  141.         "Volums,U00,"
  142.  
  143.     Getdir    Gets the directory & info(Bytes Free and name).
  144.         "GetDir,g0D,"
  145.  
  146.     AllFil    Select all files.
  147.         "AllFil,j0A,F"
  148.     ClrAll    Unselect all.
  149.         "ClrAll,l0B,"
  150.  
  151.     Bytes    Display the total number of bytes/files selected.
  152.         "Bytes ,b0F,"
  153.  
  154.     Swap    Swaps the source and destination displays.
  155.         " Swap ,W00,"
  156.  
  157.     Parent    Gets the parent of the directory. eg DF0:t/r becomes DF0:t
  158.         "Parent,P00,"
  159.     Root    Gets the root of the directory. eg DF0:t/r becomes DF0:
  160.         " Root ,R00,"
  161.  
  162.     Info    Updates the info(bytes Free and name).
  163.         " Info ,I00,"
  164.  
  165.     Copy    Copys files/dirs from one dir to another.
  166.         " Copy ,c0B,"
  167.  
  168.     Move    Moves files/dirs from one dir to another.
  169.         " Move ,m0B,"
  170.  
  171.     Delete    Delete files/dirs.  You are prompted before non empty dirs
  172.         are deleted for confirmation.
  173.         "Delete,d0B,"
  174.  
  175.     Print    Puts selected files text to the printer.
  176.         "Print ,i0F,"
  177.  
  178.     Rename    Rename files. Edit names in the prompt.
  179.         "Rename,r0B,"
  180.  
  181.     MakeDir    Make a new directory. Enter name in prompt.
  182.         "MakDir,M00,"
  183.  
  184.     Protect    Change protection of a file/dir.
  185.         "Protec,k0B,"
  186.  
  187.     CD    Makes the dir the current directory.
  188.         "  CD  ,C00,"
  189.  
  190. *    Type    Displays a text file to a window.  Esc quits anytime.
  191.         " Type ,tTF,"
  192.  
  193. *    HxType    Displays a file in hexadecimal to a window.
  194.         "HxType,hBF,"
  195.  
  196.     Instant    This performs as if you pressed the right mouse button on
  197.         all the selected files.  It will perform a relevent button
  198.         on the file if it finds one otherwise it will assume the
  199.         file is just binary and HxType it.
  200.         "Instnt,n0F,"
  201.  
  202. *    Show    Shows IFF files.  Loads in the next pic while the last
  203.         is being displayed to save a lot of time.  Use Cursor keys
  204.         to scroll around a picture bigger than the screen. Use the
  205.         left mouse mouse button or press a key to go to next.
  206.         If low on memory select one file at a time to display.
  207.         " Show ,sPF,"
  208.  
  209. *    PlaySS    Plays any file as a Sampled sound at 10000samples/sec.
  210.         RMB on a 8SVX sound file will use call this routine.
  211.         "PlaySS,pSF,"
  212.  
  213.     Search    Search files for text that you are prompted for.
  214.         The prompt has a UpperCase!=LowerCase option.
  215.         It will tell you at want offsets in the file the text is
  216.         found.
  217.         "Search,f0F,"
  218.  
  219.     VMK    My MEMORY virus detector/killer.
  220.         For a simple check to see that your memory is virus free.
  221.         Does checks of many memory locations etc that are used
  222.         by viruses.  If you get a alert use a good disk virus killer
  223.         to clear up the problem.  See the seperate program VMK v27
  224.         for docs.
  225.         " VMK  ,V00,"
  226.  
  227.  
  228.     The following buttons require you to have a external program and/or
  229.     run in your c: or similar directory.
  230.  
  231.  
  232. *    Most    Displays files compressed for viewing with Most copyright
  233.         Richard Wynn.
  234.         " Most ,eMF,Most"
  235.  
  236.     Edit    Edit selected files. Requires a editor named E in a path
  237.         such as c:.
  238.         " Edit ,e0F,Run >NIL: E"
  239.  
  240.     NewZAP    NewZAP selected files. Requires Newzap in a path such as c:.
  241.         NewZAP is a file editor © John Hodgson.
  242.         "NewZAP,e0F,Run >NIL: NewZAP"
  243.  
  244.     Run    Run selected files.  You will be prompted for optional
  245.         arguments. eg if you selected the file Diskcopy you
  246.         might want to enter "DF0: to DF1:".
  247.         " Run  ,u0F,"
  248.  
  249.     Command    Enter a command in the prompt as if you where in a CLI
  250.         window.  This press a key when output is finished.
  251.         "Comand,O00,W"
  252.  
  253. *    ARC L  ZOO L  LHArc L
  254.         Lists the compressed files for these compressors commonly
  255.         used in modem work.  Requires ARC or ZOO or LHARC to be
  256.         in an current path such as c:.
  257.         "ARC L ,vAF,ARC v"
  258.         "ZOO L ,vZF,ZOO v"
  259.         "LHarcL,vLF,LHARC l"
  260.  
  261.     ARC X  ZOO X  LHArc X
  262.         Uncompresses files for these compressors commonly used in
  263.         modem work.  Requires ARC or ZOO or LHARC to be in an
  264.         current path such as c:.  Files go to the other directory.
  265.         "ARC X ,x0F,ARC xw"
  266.         "ZOO X ,x0F,ZOO xO//"
  267.         "LHarcX,x0F,LHARC -x -m x"
  268.  
  269.     LHarc A    Adds file to a Lharc archive that you specify in the prompt.
  270.         "LHarcA,a0F,LHARC -x -r -m a"
  271.  
  272. Changing the configuration
  273. --------------------------
  274. Menu Options
  275.     Move the mouse pointer up to the left side of the title bar of the
  276.     window and press the right mouse button.  You can select whether
  277.     you want Fast&SmoothFloppyDirs or if you want Destination Files
  278.     displayed or if you want VMK to be run every 10 seconds when the
  279.     window is active(ie selected).
  280.  
  281.     Note that the DirWork FSDirs does not make use of dos buffers that
  282.     have been added using AddBuffers, but does very well with the two
  283.     commercial diskbuffering programs.
  284.  
  285.     Also there are two functions, one allows you to change the text of
  286.     any of the buttons.  You will be prompted for the current text of
  287.     the button you want to change and then for the text to replace it
  288.     with.  This can be used to change one of the default dirs such as
  289.     DH0: to something you use more often such as RAD: or C: etc
  290.  
  291.     The SAVE function will modify a DW executable to have the setup
  292.     that you currently have.  You are prompted for the name of the DW
  293.     which would most likey be C:DW.  So just change the menu options
  294.     and buttons to what you like then save them to your DW.
  295.  
  296. Changing a button:-
  297.  
  298.     You can change a button to make it do something slightly different
  299.     to something totally different.  Just press on the button then go
  300.     to the menu and select "Change last button pressed".  You are then
  301.     able to edit the button configuration text.  Which comprises of:-
  302.  
  303.     "      ,   ,       "
  304.      |||||| ||| |
  305.      |      ||| +------------Arguments for operation
  306.      |      |||
  307.      |      |||
  308.      |      ||+--------------What needs to be selected for operation
  309.      |      ||       0=Any or None. F=Files. D=Dirs. B=Files &/or Dirs.
  310.      |      ||
  311.      |      ||
  312.      |      |+--------------------- Instant action type
  313.      |      |        A=Arc file. Z=Zoo file. L=Lharc file. I=ZIP file
  314.      |      |        R=Warp file. M=Most text file. E=Executable
  315.      |      |        P=IFF ILBM picture.  S=IFF 8SVX sound.
  316.      |      |        G=IFF SMUS song. N=IFF ANIN animation.
  317.      |      |        T=Text file.  B=Unkown/Binary file.
  318.      |      |        0=No instant action type.
  319.      |      |
  320.      |      |
  321.      |      +------------------------ Internal routine the button uses
  322.      |               A capital letter signifies that the operation does
  323.      |               not require selected files/dirs.  A lower case
  324.      |               hence means the operation should require selected
  325.      |               files/dirs.
  326.      |
  327.      |
  328.      +----------------------------------------  Button Name of 6 Chars
  329.  
  330.  
  331. Information & Examples of making changes:-
  332.  
  333. Routine|  Example changes and Information
  334. letter |
  335. -------------------------------------------------------------
  336.  
  337. D    A simple change would be changing DF2: to RAD: just
  338.     " DF2: ,D00,DF2:" change to " RAD: ,D00,RAD:"
  339.  
  340.  
  341. e    To change to path for the editor from E to c:Ed
  342.     " Edit ,e0F,Run >NIL: E" change to " Edit ,e0F,Run >NIL: c:Ed"
  343.  
  344.     To make a button into a picture viewer or similar just
  345.     make a button like "Viewer,e0F,Viewer"
  346.  
  347.     Say you have a aninmation player called ShowANIN and you want
  348.     to be able to press the right mouse button on a IFF ANIM file
  349.     and have dirwork instantly recognize the file and play the
  350.     animation using ShowANIN. Something like this should work
  351.     "ShANIN,eNF,c:ShowANIN"
  352.  
  353.  
  354. O    If you don't want command to open a window for output
  355.     "Comand,O00,W" change to "Comand,O00,N"
  356.  
  357.     Say you have a calculator that you commonly use. Do something
  358.     like this.   " Calc ,O00,NRun >NIL: Calculator"
  359.                               ^^^^^^^^^^^^^^^^^^^^
  360.     where the above is what you would type in from cli.
  361.     When you press the button a prompt will come up, you can change
  362.     it or just select GoDoIt.  Similar manipulations of the O routine
  363.     could give you a format, diskcopy or similar button.
  364.  
  365.  
  366. x & v    You could swap the instant letter from the ZOO/ARC/LHARC list
  367.     and extract buttons so that right mouse button extracts instead of
  368.     lists.
  369.  
  370. There are heaps more configuration changes & new buttons you could make!
  371. If you are a registered user just describe what sort of button you would
  372. like configured and I will give you the button configuration text for it
  373. if it is possible.
  374.  
  375.  
  376. Bye,
  377.     Chris Hames (Available for any Amiga work)
  378.  
  379.